Propertyを作成し、SceneItem
オブジェクトに追加します。
クラスタプロパティの中には常に完全なClusterオブジェクトに追加できるものもあります（Cluster.IsAlwaysCompleteを参照）。これらの制限事項は、Preset引数の「指定可能な値」セクションにリストされています。
oReturn = SceneItem.AddProperty( Preset, [BranchFlag], [Name] ); |
ClusterProperty、CustomProperty、Property、UserDataBlob、またはUserDataMap（使用されたプリセットによる）
| パラメータ | タイプ | 詳細 |
|---|---|---|
| プリセット | String | この引数には、Property Preset
の名前またはファイル名やプリセット ファイルへの完全パスを含む文字列が格納されます。すべてのプリセットが、すべての SceneItem
オブジェクトに対して有効とは限りません。これら個々のプリセット タイプのページに制限が一覧表示されています(ClusterProperty
Presets、CustomProperty
Presets、Property (Object)
Presets、UserDataBlob Presets、および
UserDataMap
Presets)。 作成されるプロパティのタイプはこの引数により決定されます。たとえば、"CustomProperty" は空のCustomPropertyを作成し、"UserDataBlob" はUserDataBlobを作成します。 |
| BranchFlag | Boolean | ture の場合は、新しく作成されたプロパティも、SceneItemの下にネストされたすべてのオブジェクトの下に表示されます。
デフォルト値: false |
| Name | String | 新しいプロパティの名前を表します（SIObject.Nameを参照）。 |
// Very simple example of AddProperty // Create an Annotation property, // fill in some content and show the Property // Page. var oA = ActiveSceneRoot.AddProperty( "Annotation" ) ; oA.text = "This is a comment" ; InspectObj( oA ) ; |
'VBScript example
set sceneItem = Application.ActiveProject.ActiveScene.Root.AddNull
set prop = sceneItem.AddProperty("CustomProperty",false, "MyCustomParam")
LogMessage "SceneItem's custom property name: " & prop.FullName
|